﻿RADIO GO 1.0.2
Free internet radio for Windows, made for screen reader users.
Made by John Carlo Amog (FilTalk) - https://filtalk.org


==================================================
1. WHAT RADIO GO IS
==================================================

Radio Go plays tens of thousands of internet radio stations from all over the
world. The station list comes from radio-browser.info, a free community list.
Radio Go gets the whole list as one small file from filtalk.org (about 2 MB,
once a day), so the lists open at once and still work without internet.
Philippine stations come first, then the United States, then every other
country from A to Z.

Radio Go works with NVDA, JAWS, Narrator and other screen readers. Every
control has a name, and Radio Go speaks what happens (playing, stopped,
volume, errors). With NVDA it speaks through NVDA directly.

Radio Go is PORTABLE. There is no installer. Everything it saves (settings,
favorites, history, recordings) stays inside its own folder. You can copy
the folder to a flash drive and use it on another computer.

Radio Go needs Windows 10 or Windows 11 (64-bit) and an internet connection.
Nothing else needs to be installed.


==================================================
2. STARTING RADIO GO
==================================================

1. Unzip "Radio Go.zip" to a place where you can save files, for example
   your Desktop or Documents. Do not put it in "Program Files", because
   Radio Go could not save your favorites there.
2. Open the "Radio Go" folder and press Enter on RadioGo.exe.
3. The first time, your Favorites list already has Shine Radio in it.
   Press Enter on it to start listening.


==================================================
3. THE WINDOW
==================================================

Radio Go has five tabs. There are three ways to move between them:

  - Ctrl+1 to Ctrl+5 (see below) open a tab and put you straight in its list.
  - Ctrl+Tab and Ctrl+Shift+Tab go to the next or previous tab, also straight
    into its list.
  - Shift+Tab from a list takes you to the tab names. There, Left and Right
    arrow only move between the tab names; you stay on the tab names. Press
    Tab to go into the list (or the search box) of the tab you are on.

  Favorites (Ctrl+1)   Your own list of stations.
  Countries (Ctrl+2)   Every country. Press Enter on a country to see its
                       stations. Press Backspace to go back to the countries.
  Genres    (Ctrl+3)   Music styles and topics, like pop, news, christian,
                       opm, jazz. Enter opens a genre, Backspace goes back.
  Search    (Ctrl+4)   Type part of a station name and press Enter.
                       Ctrl+F also jumps to the search box.
  History   (Ctrl+5)   The last 50 stations you played, newest first.

In every list, move with the Up and Down arrows. You can also type the first
letters of a name to jump to it (for example, type "lo" for Love Radio).
Typing one letter again moves to the next name with that letter.

At the bottom of the window there is a status line. It shows the last
message Radio Go spoke.

The window title says which station is playing, and says "recording" while
recording.


==================================================
4. ALL KEYS
==================================================

All keys work inside Radio Go only (when the Radio Go window is active).
They are also shown in the menus (press Alt to open the menus).

Playing
  Enter                 Play the station you are on.
  Space                 Play or stop.
  F2                    Say the name of the station that is playing.

Volume
  Ctrl+Up arrow         Volume up (5 percent).
  Ctrl+Down arrow       Volume down (5 percent).
  Ctrl+Shift+Up arrow   Volume up a little (1 percent).
  Ctrl+Shift+Down arrow Volume down a little (1 percent).
  Ctrl+M                Mute or unmute.

  The volume is Radio Go's own volume. It does not change the Windows
  volume, so your screen reader keeps its own loudness. Radio Go
  remembers the volume when you close it.

Favorites
  Ctrl+D                Add the station you are on to Favorites, or remove
                        it if it is already a favorite. If you are not on a
                        station, it adds the one that is playing.
  Delete                In Favorites: remove the station.
                        In History: remove the station from the history.
  Alt+Up arrow          In Favorites: move the station up.
  Alt+Down arrow        In Favorites: move the station down.
  Ctrl+N                Add a station by its link (see section 6).

Lists
  Backspace             In Countries or Genres: go back to the list of
                        countries or genres.

Extras
  Ctrl+R                Start or stop recording.
  Ctrl+T                Sleep timer.
  Ctrl+L                Alarm.
  Ctrl+P                Settings.

Tabs
  Ctrl+1 to Ctrl+5      Favorites, Countries, Genres, Search, History.
  Ctrl+F                Go to the search box.

Help
  F1                    Open this read me.
  Alt+F4                Close Radio Go.


==================================================
5. RECORDING
==================================================

Press Ctrl+R while a station plays. Radio Go saves the sound exactly as the
station sends it, so there is no loss of quality. Press Ctrl+R again to stop.

The files go to the "recordings" folder inside the Radio Go folder. The file
name has the station name and the date and time. Most stations give an .mp3
file; some give an .aac file. Both play in normal music players.

To open the folder: File menu, "Open the recordings folder".
To save recordings somewhere else: Settings (Ctrl+P), "Change folder".

If the station is cut off while recording, the recording stops. Start it
again after Radio Go reconnects.

Please respect the stations: recordings are for your own personal use.


==================================================
6. ADDING A STATION BY LINK
==================================================

If you know the stream link of a station (for example from the station's
website), press Ctrl+N. Type the station name, paste the link (it starts
with http:// or https://) and press Enter. The station is added to your
Favorites and starts playing.

Links to .pls and .m3u playlists also work.


==================================================
7. SLEEP TIMER
==================================================

Press Ctrl+T and choose when the radio should stop: 15, 30, 45 minutes,
1 hour, 1 hour 30 minutes, 2 hours or 3 hours. When the time comes, the
sound gets quieter slowly for 5 seconds and then stops.

To turn it off, press Ctrl+T and choose "Turn the sleep timer off". The
dialog also tells you how much time is left.


==================================================
8. ALARM
==================================================

Press Ctrl+L.
  - Check "Turn the alarm on".
  - Hour: 0 to 23. For example 6 = 6 in the morning, 18 = 6 in the evening.
  - Minute: 0 to 59.
  - Station: the station playing now, or one of your favorites.
  - "Every day": if it is not checked, the alarm rings only once.

At that time, Radio Go starts the station. The sound starts low and rises.

IMPORTANT: Radio Go must be open for the alarm to ring. You can minimize it.
Make sure the computer does not go to sleep.


==================================================
9. SETTINGS (Ctrl+P)
==================================================

  Sound output       Where you hear the radio: Windows default, or your
                     speakers, earphones, headset, and so on.
  Equalizer          Normal, Bass boost (more bass), or Voice (clearer
                     talk, good for news and talk shows).
  Balance            -100 = left side only, 0 = middle, 100 = right only.
  Allow volume above 100 percent
                     Lets the volume go up to 150 percent for very quiet
                     stations. Loud stations may sound broken this high.
  Fade in and out    The sound rises softly when a station starts and
                     lowers softly when you stop it.
  Play the last station when Radio Go opens
  Check for updates when Radio Go opens
  Recordings folder  Where recordings are saved.


==================================================
10. WHEN A STATION STOPS OR DOES NOT PLAY
==================================================

Internet radio stations go off the air sometimes. Radio Go only shows
stations that the station list says are working, but a station can still
be down for a while.

  - If a station does not answer, Radio Go tells you. Pick another station
    or try again later.
  - If a playing station is cut off, Radio Go reconnects by itself (up to 5
    tries, 3 seconds apart) and tells you when it is back.
  - Without internet, Countries, Genres and Search show the last lists Radio
    Go saved, but stations cannot play.
  - Radio Go plays MP3 and AAC stations. A few stations use other formats and
    are left out of the lists.

Radio Go does not show song names. Most stations, especially in the
Philippines, do not send them. F2 tells you the station name.


==================================================
11. UPDATES
==================================================

When Radio Go opens, it checks filtalk.org for a newer version (you can turn
this off in Settings). You can also check any time: Help menu, "Check for
updates". If there is a new version, Radio Go asks you first. Then it
downloads it, closes, updates itself and opens again.

Your settings, favorites, history and recordings are kept.

Radio Go does not send anything about you anywhere. It only contacts:
  - filtalk.org, to get the daily station list and to check for updates,
  - radio-browser.info, only if the filtalk.org list cannot be reached,
  - the radio stations you play.


==================================================
12. FILES IN THE RADIO GO FOLDER
==================================================

  RadioGo.exe                 The program.
  RadioGo.exe.config          Windows settings for the program. Keep it.
  bass.dll, bass_aac.dll      The sound engine (MP3 and AAC).
  nvdaControllerClient64.dll  Lets Radio Go speak through NVDA.
  README.txt                  This file.
  LICENSE.txt                 The Radio Go license.
  THIRD-PARTY-NOTICES.txt     Licenses of the parts made by others.

Made by Radio Go while you use it:
  settings.ini                Your settings.
  favorites.txt               Your favorites (one station per line:
                              name|link|country|genres).
  history.txt                 Your history.
  cache\                      The saved station list, for use without internet.
  recordings\                 Your recordings.

To start fresh, close Radio Go and delete settings.ini, favorites.txt and
history.txt.

To move Radio Go to another computer, copy the whole folder.


==================================================
13. HELP AND CONTACT
==================================================

Website: https://filtalk.org
Made by John Carlo Amog (FilTalk).

Thank you for listening with Radio Go!
